<html>
<head><meta charset="utf-8"><title>doc.rust-lang.org: where to ask? · general · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/index.html">general</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html">doc.rust-lang.org: where to ask?</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="227904359"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227904359" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227904359">(Feb 26 2021 at 09:47)</a>:</h4>
<p>Is there a place on zulip where maintainers of <code>doc.rust-lang.org</code> (the website) are?</p>
<p>Or should I just open an issue as per the <a href="https://github.com/rust-lang/www.rust-lang.org/blob/master/CONTRIBUTING.md">CONTRIBUTING.md</a>?</p>



<a name="227904728"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227904728" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Laurențiu <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227904728">(Feb 26 2021 at 09:51)</a>:</h4>
<p>If it's about <code>rustdoc</code>, <span class="user-mention" data-user-id="232545">@Joshua Nelson</span> is around, but filing an issue is fine, too</p>



<a name="227905225"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227905225" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227905225">(Feb 26 2021 at 09:57)</a>:</h4>
<p>It's about the website, namely the static assets deployed on <code>doc.rust-lang.org/std</code>. I'd like to underatand the workflow that generates those files.</p>
<p>Think I'll ping one the people I see commenting the issues on <a href="https://github.com/rust-lang/www.rust-lang.org/issues">https://github.com/rust-lang/www.rust-lang.org/issues</a> :)</p>



<a name="227906446"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227906446" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Giacomo Stevanato <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227906446">(Feb 26 2021 at 10:08)</a>:</h4>
<p>They're generated by <code>rustdoc</code>.</p>
<ul>
<li>If you're interested to build the docs for your crate, you can use <code>cargo doc</code>. See the  <a href="https://doc.rust-lang.org/nightly/rustdoc/">rustdoc book</a> for more informations.</li>
<li>If you're interested to build the stdlib docs, you can use <code>./x.py doc --stage 1 library/std</code>. See <a href="https://rustc-dev-guide.rust-lang.org/rustdoc.html">this page</a> on the rustc dev book for more informations</li>
<li>If you're interested in the <code>rustdoc</code> internals, you can read <a href="https://rustc-dev-guide.rust-lang.org/rustdoc-internals.html">this page</a> on the rustdoc internal.</li>
</ul>



<a name="227907953"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227907953" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227907953">(Feb 26 2021 at 10:23)</a>:</h4>
<p>thanks for the hints. Now I have a bit more context.</p>
<p>I'm just missing how the static assets os the std library are deployed on <code>doc.rust-lang.org</code>. I see <code>www.rust-lang.org</code> is built with a <a href="https://github.com/rust-lang/www.rust-lang.org/blob/master/Dockerfile">dockerfile</a> but I don't see how <code>doc.rust-lang.org</code> is being cooked. I'll figure that out .</p>



<a name="227983147"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227983147" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227983147">(Feb 26 2021 at 19:55)</a>:</h4>
<p>If you want to know how the assets are copied onto the website, you probably want to ask <code>T-infra</code>: <a class="stream" data-stream-id="242791" href="/#narrow/stream/242791-t-infra">#t-infra</a></p>



<a name="227983170"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227983170" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227983170">(Feb 26 2021 at 19:55)</a>:</h4>
<p>Rustdoc generates the assets, <code>T-infra</code> manages deployment via CI.</p>



<a name="227983240"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227983240" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227983240">(Feb 26 2021 at 19:55)</a>:</h4>
<p>Probably something in <code>src/ci/</code> or <code>.github/workflows</code></p>



<a name="227984703"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/227984703" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Noah Lev <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#227984703">(Feb 26 2021 at 20:04)</a>:</h4>
<p>You can also ask <code>T-rustdoc</code> questions in <a class="stream" data-stream-id="266220" href="/#narrow/stream/266220-rustdoc">#rustdoc</a>!</p>



<a name="228008905"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/doc.rust-lang.org%3A%20where%20to%20ask%3F/near/228008905" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F.html#228008905">(Feb 26 2021 at 22:54)</a>:</h4>
<p><span class="user-mention silent" data-user-id="307537">Camelid</span> <a href="#narrow/stream/122651-general/topic/doc.2Erust-lang.2Eorg.3A.20where.20to.20ask.3F/near/227983240">said</a>:</p>
<blockquote>
<p>Probably something in <code>src/ci/</code> or <code>.github/workflows</code></p>
</blockquote>
<p>yup, <span class="user-mention silent" data-user-id="121055">Pietro Albini</span> gave me <a href="#narrow/stream/242791-t-infra/topic/Question.20about.20.22doc.2Erust-lang.2Eorg.2Fstd.22">a quick overview</a></p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>